home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / addhost.man < prev    next >
Encoding:
Text File  |  1990-02-21  |  6.6 KB  |  201 lines
  1.  
  2.  
  3.  
  4. ADDHOST                   User Commands                   ADDHOST
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      addhost - Add a new host to the system
  12.  
  13. SSYYNNOOPPSSIISS
  14.      aaddddhhoosstt [_o_p_t_i_o_n_s] [--nn _n_a_m_e  --ii  _i_n_t_e_r_n_e_t  --aa  _n_e_t_A_d_d_r_e_s_s  --mm
  15.      _m_a_c_h_i_n_e_T_y_p_e --ss _s_w_a_p_D_i_r]
  16.  
  17. OOPPTTIIOONNSS
  18.      --aa _a_d_d_r_e_s_s     The --aa flag is required, and is used  to  set
  19.                     the  local network address of the host.  Usu-
  20.                     ally _a_d_d_r_e_s_s is an Ethernet address,  and  is
  21.                     of the form "a:b:c:d:e:f".
  22.  
  23.  
  24.      --dd _d_o_m_a_i_n      Used to set  the  local  domain.  The  _d_o_m_a_i_n
  25.                     string  is  appended  to the name provided by
  26.                     the --nn flag to produce the full name  of  the
  27.                     machine.   The default is to parse the domain
  28.                     name from the _s_p_r_i_t_e_h_o_s_t_s file.  If the  file
  29.                     is empty then the --dd flag must be given.
  30.  
  31.  
  32.      --hh, --hheellpp, --??  These options cause  a  help  listing  to  be
  33.                     printed.
  34.  
  35.  
  36.      --ii _i_n_t_e_r_n_e_t    _I_n_t_e_r_n_e_t is the internet address of the host.
  37.                     The  address  is in the form "a.b.c.d".  This
  38.                     flag is required.
  39.  
  40.  
  41.      --II _s_p_r_i_t_e_I_D    The --II flag is used to assign a Sprite ID  to
  42.                     the  host.   Care must be taken that _s_p_r_i_t_e_I_D
  43.                     does not conflict with the id of an  existing
  44.                     host.  If the --II flag is omitted aaddddhhoosstt will
  45.                     use a Sprite ID that is one greater than  the
  46.                     largest id found in the _s_p_r_i_t_e_h_o_s_t_s file.
  47.  
  48.  
  49.      --mm _m_a_c_h_i_n_e_T_y_p_e This flag sets the machine type of  the  host
  50.                     to  be  added.  This flag must be used.  Sup-
  51.                     ported machine types are _s_u_n_3,  _s_u_n_4,  _s_u_n_4_c,
  52.                     and _d_s_3_1_0_0.
  53.  
  54.  
  55.      --nn _n_a_m_e        _N_a_m_e is the name of the host.  This  flag  is
  56.                     required.
  57.  
  58.  
  59.      --ss _s_w_a_p_D_i_r     The --ss defines _s_w_a_p_D_i_r to be the directory in
  60.  
  61.  
  62.  
  63. Sprite v.1.0       Printed:  February 20, 1990                  1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ADDHOST                   User Commands                   ADDHOST
  71.  
  72.  
  73.  
  74.                     which  to  create  the swap directory for the
  75.                     new host.  The default is /swap.  If  a  dif-
  76.                     ferent  directory  is  specified  then a link
  77.                     will be make in /swap.
  78.  
  79.  
  80.      --tt _n_e_t_T_y_p_e     The --tt flag is used to set the  type  of  the
  81.                     network   associated   with  the  host.   The
  82.                     default is _e_t_h_e_r, indicating that the host is
  83.                     connected  to the system via an Ethernet, and
  84.                     the the argument to the --aa flag is the Ether-
  85.                     net address of the host.  The only other sup-
  86.                     ported value  for  the  _n_e_t_T_y_p_e  argument  is
  87.                     _i_n_e_t,   indicating   that  a  gateway  exists
  88.                     between the host and the  root  file  server.
  89.                     In  this  case the argument to the --aa flag is
  90.                     the Ethernet address of the gateway machine.
  91.  
  92.  
  93.      --RR             AAddddhhoosstt will not allow a host to be added  if
  94.                     the  name  of the new host conflicts with the
  95.                     name of an existing host.  If the --RR flag  is
  96.                     specified  than the existing host information
  97.                     is replaced with the information for the  new
  98.                     host.   If  you  are upgrading a machine from
  99.                     one machine type to another but retaining the
  100.                     name then the --RR flag should be used.
  101.  
  102.  
  103.      --rr _r_o_o_t        The --rr flag is used to specify that the  root
  104.                     of  the  Sprite filesystem is something other
  105.                     than "/".
  106.  
  107. _________________________________________________________________
  108.  
  109.  
  110.      --oo _o_w_n_e_r       Used to specify the owner or primary user  of
  111.                     the  machine.   This  information is added to
  112.                     /sprite/admin/hosts.
  113.  
  114.  
  115.      --ll _l_o_c_a_t_i_o_n    Used to specify the location of the  machine.
  116.                     This      information     is     added     to
  117.                     /sprite/admin/hosts.
  118.  
  119.  
  120.      --TT _m_a_c_h_i_n_e _d_e_s_c_r_i_p_t_i_o_n
  121.                     The --TT flag  is  used  to  specify  the  full
  122.                     machine   description.    Examples  might  be
  123.                     "sun3/75" or "sun4/260".  This information is
  124.                     added to /sprite/admin/hosts.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131. Sprite v.1.0       Printed:  February 20, 1990                  2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. ADDHOST                   User Commands                   ADDHOST
  139.  
  140.  
  141.  
  142. DDEESSCCRRIIPPTTIIOONN
  143.      The aaddddhhoosstt command is used to add a new host to the system.
  144.      It  should  only  be run by the super-user (root).  Invoking
  145.      aaddddhhoosstt without any options will  cause  it  to  run  in  an
  146.      interactive  mode  where  you  will be prompted for the host
  147.      name, type, etc.  These  parameters  can  also  be  set  via
  148.      options  on the command line.  The use of any options causes
  149.      aaddddhhoosstt to not run interactively.  In this  case  a  minimum
  150.      set  of  options  must  be used.  The --aa, --ii, --nn, --mm, and --ss
  151.      flags must be used to indicate the local  address,  Internet
  152.      address,  host  name, host machine type, and swap directory,
  153.      respectively.  The options are described in more  detail  in
  154.      the section above.
  155.  
  156.      As the aaddddhhoosstt script runs it will print out information  on
  157.      the  actions  it is taking.  Once the script is complete you
  158.      should  look  in  /sprite/admin/howto/addNewHost   for   any
  159.      remaining steps in the installation procedure.
  160.  
  161.  
  162. FFIILLEESS
  163.      The following files are edited by aaddddhhoosstt: /etc/spritehosts,
  164.      /etc/hosts.equiv, /sprite/admin/hosts
  165.  
  166.  
  167. KKEEYYWWOORRDDSS
  168.      spritehosts, new, host, hosts, hosts.equiv
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197. Sprite v.1.0       Printed:  February 20, 1990                  3
  198.  
  199.  
  200.  
  201.